home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 21 / Cream of the Crop 21 (Terry Blount) (October 1996).iso / editor / auror300.zip / TIPS.DOX < prev    next >
Text File  |  1996-07-17  |  19KB  |  453 lines
  1.  
  2.  
  3. User Tips
  4. ─────────
  5. This file contains a few miscellaneous Aurora user tips which you may
  6. wish to review. For complete documentation on how to install and use
  7. Aurora, see the Users Guide (User.dox). Note that any key definitions
  8. shown here are the Aurora-style defaults.
  9.  
  10.  
  11. Basic Configuration
  12. ───────────────────
  13.   The editor should always be installed in an empty directory. Never
  14.    mix files from different editor versions.
  15.  
  16.   Whenever you make a change to any of the editor configuration files
  17.    (such as Config.aml, Kbd.aml, Menu.aml, etc.), you must execute the
  18.    'recompile' command ('Recompile the editor' <alt f2> on the Set menu)
  19.    for your changes to take effect.
  20.  
  21.   If you prefer to start Aurora by another name, you can simply rename
  22.    the file A.exe to whatever you wish (such as E.exe). Do not rename
  23.    any other files distributed with the editor.
  24.  
  25.   You can re-install Aurora by selecting Full Installation from the
  26.    Macro List on the Macro menu.
  27.  
  28.  
  29. The Keyboard
  30. ────────────
  31.   When adding new key definitions to Kbd.aml, be sure to place each
  32.    definition in the appropriate 'object' for the window in which you
  33.    would like the key to be active. For most editing key definitions,
  34.    this will be the 'edit' object.
  35.  
  36.   If you have added or changed keyboard definitions, you will probably
  37.    also want to change any Menu definitions which show the old keys.
  38.  
  39.   To prevent the editor from using the keypad <grey/>, <grey*>,
  40.    <grey->, and <grey+> keys as function keys, remove option 'g' from
  41.    'kbdoptions' in System.aml.
  42.  
  43.   To execute a key or macro function from the Dos command line, use the
  44.    '-e' command line option. Key or event names must be enclosed in
  45.    double quotes. For example:
  46.  
  47.      C>a -emymacro
  48.         // executes the function 'mymacro' after the editor is started
  49.  
  50.      C>a -e"<shift f1>" -e"<alt =>"
  51.         // simulates <shift f1>, <alt => after the editor is started
  52.  
  53.  
  54. The Mouse
  55. ─────────
  56.   If scrolling is too fast when using the mouse, change the Scroll
  57.    Delay on the Mouse Options dialog box to a higher value.
  58.  
  59.   To hide the mouse pointer whenever a key pressed, change the
  60.    appropriate option on the Mouse Options dialog box.
  61.  
  62.  
  63. The Menus
  64. ─────────
  65.   If part of a pull-down menu is displayed off the edge of the screen,
  66.    use the mouse to grab the menu border and drag the menu to a better
  67.    position.
  68.  
  69.   To hide the menu bar so that it is only displayed when <esc> or the
  70.    right mouse button is pressed, remove the menu bar on the Window
  71.    Style 1 dialog box.
  72.  
  73.  
  74. Prompts
  75. ───────
  76.   The Ascii Chart <alt => can be displayed from within a prompt and
  77.    used to enter any character. The Enter Literal <ctrl [> command can
  78.    also be used to enter any character in a prompt. In addition, you can
  79.    enter any character by holding down the <alt> key, then entering the
  80.    decimal Ascii value of the character on the keypad, and then
  81.    releasing the <alt> key.
  82.  
  83.   Use <pgup> or <pgdn> within a prompt, or click on the prompt retrieve
  84.    tab () to display a popup menu of all prompt history. You can copy a
  85.    string from the menu to the prompt by pressing the <enter> key or the
  86.    left mouse button.
  87.  
  88.   Use the Prompt Style command on the Window menu to sample the four
  89.    editor prompt styles. Select Save Configuration on the Set menu to
  90.    make the current style the default prompt style.
  91.  
  92.   To move the cursor a relative number of lines away from the current
  93.    position in the Go To Line <ctrl j> prompt, specify '+' or '-' before
  94.    the line number.
  95.  
  96.   The Macro Expression prompt <ctrl v> on the Macro menu can be used as
  97.    a command line calculator, since the macro language compiler and
  98.    interpreter are available at this prompt. For example:
  99.  
  100.      Macro Expression>  say 1 + 2 + 30 - 40    <enter>
  101.        // displays -7
  102.      Macro Expression>  msgbox (4 * 15) mod 7  <enter>
  103.        // displays 4 in a message box
  104.      Macro Expression>  write 1 + 2 * 3 + 4    <enter>
  105.        // enters the string '11' at the cursor
  106.  
  107.  
  108. The Desktop
  109. ───────────
  110.   You can prevent windows from remembering their sizes, cursor
  111.    positions, and settings by checking the appropriate options on
  112.    Desktop Options dialog box.
  113.  
  114.   To use the existing Dos screen as the editor background when the
  115.    editor is started, change the Background Fill String to '' (null) on
  116.    the Video Options dialog box.
  117.  
  118.   If your video card supports special video modes such as 132 x 43, you
  119.    can use these video modes within the editor by setting the Rows and
  120.    Columns to 'Dos' on the Video Options dialog box. Then select Save
  121.    Configuration on the Set menu, exit the editor, and set the desired
  122.    video mode in Dos before re-starting the editor.
  123.  
  124.   Enter the 'showentry' command in the Macro Expression prompt to
  125.    display the screen as it appeared in Dos before the editor was
  126.    started.
  127.  
  128.  
  129. Syntax Highlighting
  130. ───────────────────
  131.   Syntax highlighting definitions are located in the Syn\ directory.
  132.  
  133.   If you are using syntax highlighting with multi-line comments in your
  134.    program source code, you may wish to increase the number of lines to
  135.    scan backward in the appropriate syntax definition file in the Syn\
  136.    directory. Note however, that this may decrease scrolling performance
  137.    for highlighted files.
  138.  
  139.   The Hilite Word <ctrl \> command highlights all occurrences of the
  140.    word at the cursor. This can be very useful for finding instances of
  141.    a word in a document, or marking occurrences of variables, functions,
  142.    or other identifiers in your program source code.
  143.  
  144.   Individual keywords can be highlighted in colors other than the
  145.    default keyword color by treating the keyword as a public object
  146.    variable and assigning it the desired color attribute. For example,
  147.    in Syntax.aml:
  148.  
  149.      keyword
  150.        :      // end of keyword list
  151.  
  152.      _if   = color brightred on blue
  153.      _else = color yellow    on blue
  154.  
  155.  
  156. History
  157. ───────
  158.   To erase all of your existing prompt history, window positions, etc.,
  159.    simply delete Default.prj after you have exited the editor.
  160.  
  161.   Do not attempt to manually update the file Default.prj. This file is
  162.    automatically updated by the editor during normal usage.
  163.  
  164.  
  165. The File Manager
  166. ────────────────
  167.   To open a file manager window for the current directory from the Dos
  168.    command line, enter 'a .'.
  169.  
  170.   To open a file from the file manager while also closing the file
  171.    manager window, use <ctrl enter>, or check the option 'Quit on Open'
  172.    on the file manager options dialog box.
  173.  
  174.   To locate a filename within the file manager or a file picklist,
  175.    enter the first few characters of the desired filename until the
  176.    cursor is positioned at the file. To locate a directory, enter a
  177.    backslash character (\) before the first letter.
  178.  
  179.   To create a separate file manager window from a directory in the file
  180.    manager, use <shift o>.
  181.  
  182.   To display the amount of disk space used by an entire directory and
  183.    all subdirectories, use the Statistics command on the Command menu.
  184.  
  185.   To generate a file manager listing of all files in all directories on
  186.    the C drive, run the Where macro and and specify a filespec of
  187.    'C:\*.*'. To generate a listing of all files on your computer, run
  188.    Where with a filespec of '*.*' (Warning: these filespecs may generate
  189.    listings with tens of thousands of files, which may take some time to
  190.    sort.)
  191.  
  192.   To display Windows/95 long names in the file manager, set the format
  193.    to Variable on the File Manager options dialog box.
  194.  
  195.   To make more room for long names in the file manager, configure the
  196.    time to be displayed without seconds (on the International Options
  197.    dialog box), and the file size to be displayed in 1k increments (on
  198.    the File Manager Options dialog box).
  199.  
  200.  
  201. Opening Files
  202. ─────────────
  203.   To open a file from the Dos command line and place the cursor on a
  204.    specific line, enter the option 'l' followed by the line number. For
  205.    example:
  206.  
  207.      C>a myfile.txt/l253
  208.        // opens 'm